package com.campus.food.mapper;

import com.campus.food.model.entity.Banner;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 轮播图数据访问接口
 * 
 * @author Claude3.7 Sonnet
 * @since 2025-06-12
 */
public interface BannerMapper {
    
    /**
     * 插入轮播图
     * 
     * @param banner 轮播图信息
     * @return 影响行数
     */
    int insert(Banner banner);
    
    /**
     * 根据ID查询轮播图
     * 
     * @param id 轮播图ID
     * @return 轮播图信息
     */
    Banner selectById(Long id);
    
    /**
     * 更新轮播图
     * 
     * @param banner 轮播图信息
     * @return 影响行数
     */
    int updateById(Banner banner);
    
    /**
     * 根据ID删除轮播图
     * 
     * @param id 轮播图ID
     * @return 影响行数
     */
    int deleteById(Long id);
    
    /**
     * 查询所有轮播图（按排序顺序升序）
     * 
     * @return 轮播图列表
     */
    List<Banner> selectAll();
    
    /**
     * 根据状态查询轮播图（按排序顺序升序）
     * 
     * @param status 状态（0-禁用，1-启用）
     * @return 轮播图列表
     */
    List<Banner> selectByStatus(Integer status);
    
    /**
     * 分页查询轮播图
     * 
     * @param offset 偏移量
     * @param limit 数量限制
     * @param status 状态（可选）
     * @return 轮播图列表
     */
    List<Banner> selectPage(@Param("offset") int offset, @Param("limit") int limit, @Param("status") Integer status);
    
    /**
     * 获取轮播图总数
     * 
     * @param status 状态（可选）
     * @return 轮播图总数
     */
    long count(@Param("status") Integer status);
    
    /**
     * 批量删除轮播图
     * 
     * @param ids ID列表
     * @return 影响行数
     */
    int deleteBatch(@Param("ids") List<Long> ids);
} 